Permissions Class

Enables you to test, set, and clear the permissions of FolderItems in operating systems that support this concept (Mac OS X and Linux). You can get and set the permissions of a FolderItem as an octal Integer via the Permissions property of the FolderItem class.

Events

None

Properties

GIDBit

OtherWrite

GroupExecute

OwnerExecute

GroupRead

OwnerRead

GroupWrite

OwnerWrite

OtherExecute

StickyBit

OtherRead

UIDBit


Methods

None

More information available in parent classes: Object


Constructor

You must pass the Integer permissions value of the FolderItem in the Permissions constructor. For example:

Dim perms as New Permissions(FolderItem1.Permissions)

Notes

On Unix-based operating systems, permissions can be represented as a three-digit numeric code, in which each digit ranges from 0 to 7 (a.k.a, octal number). The digits correspond to the permissions of the FolderItem Owner, the owning Group, and Other users not in the owning Group, in that order, from left to right.

The code for each digit is computed using the following values:

ValuePermission TypeDescription
4 Read permissions User or group can open and read the FolderItem.
2 Write permissions User or group can open and write to the FolderItem.
1 Execute permissions User or group can execute the file or read the directory.

For directories, Execute permissions means that the user or group can list the contents of the directory and examine the files that the user has permission to read.

For each digit, the permissions are expressed by adding up the values. Each digit can take on eight possible values:

ValueDescription
0 No permissions
1 Execute permissions
2 Write permissions
3 Write and Execute permissions
4 Read permissions
5 Read and Execute permissions
6 Read and Write permissions
7 Read, Write, and Execute permissions

For example, the code "764" is interpreted as follows:

ValueUser TypeDescription
7 Owner Read, Write, and Execute permissions
6 Group Read and Write permissions
4 Others Read permissions


See Also

FolderItem class.